Add IDNA domain encode/decode functions

* puny.el (puny-decode-domain): New function.
(puny-encode-domain): Ditto.
(puny-decode-digit): Fix digit decoding error.

Rename idna.el to puny.el

* puny.el: Renamed from idna.el to avoid name collisions with
the external idna.el library.

lisp/gnus/mml-sec.el (mml-secure-bcc-is-safe): Keep old Emacsen compatibility

* lisp/gnus/mml-sec.el (mml-secure-bcc-is-safe):
Don't use split-string with 4th arg for old Emacsen compatibility.

* idna.el (idna-decode-string-internal): Implement decoding.

Further IDNA tweaks

(idna-encode-string): Make idna-encode-string safe for
non-ASCII use.

Clean up the code slightly

Added basic idna encoding support

* lisp/net/idna.el: New file.

Disconnection fixes for erc

* lisp/erc/erc-backend.el (erc-server-reconnect-p): Don't
reconnect if the user has disconnected explicitly (bug#4589).

Further erc asynch fixes

* lisp/erc/erc-backend.el (erc-process-sentinel-2): Make
erc-server-connect to return even if the connection is not
ready.  Then erc-open and erc-server-reconnect do the
same. (bug#5650).

Copyright-paperwork-exempt: yes

Make erc connect asynchronously

* lisp/erc/erc-backend.el (erc-server-reconnect): Use it to
reconnect asynchronously.

* lisp/erc/erc-backend.el (erc-open-network-stream): New function (bug#5650).

Proxy error in erc with multiple clients

* lisp/erc/erc.el (erc-channel-receive-names): Fix errors
generated when multiple IRC clients talk to a single IRC proxy
(bug#19034).

Fix mml-sec build warnings

* lisp/gnus/mml-sec.el: Fix warnings by adding autoloads
(bug#18718).

(eww-setup-buffer): Restore left-to-right defaults

* eww.el (eww-setup-buffer): Restore left-to-right defaults.

* lisp/gnus/mml-sec.el (mml-secure-bcc-is-safe): Fix typo in last check-in.

Identify unsafe combinations of Bcc and encryption

* lisp/gnus/gnus-util.el (gnus-subsetp): New function
* lisp/gnus/mml-sec.el (mml-secure-safe-bcc-list): New variable
* lisp/gnus/mml-sec.el (mml-secure-bcc-is-safe): New function

; Auto-commit of ChangeLog files.

* shr.el (shr-descend): Allow using lambdas in external functions.

* admin/gitmerge.el: Tweaks that seemed necessary

* admin/gitmerge.el (gitmerge-skip-regexp): Remove "sync".
(gitmerge-maybe-resume): Provide explicit empty commit message.

Use a different port for TLS erc

* lisp/erc/erc.el (erc-default-port-tls): New variable
(bug#19497).
* lisp/erc/erc.el (erc-tls): Use it.

Copyright-paperwork-exempt: yes

Make relative URL parsing and resolution consistent with RFC 3986 (bug#22044)

* test/lisp/url/url-parse-tests.el: Add tests covering url-generic-parse-url.
* test/lisp/url/url-expand-tests.el: Add tests covering url-expand-file-name.
* lisp/url/url-parse.el (url-generic-parse-url): Keep empty fragment
information in URL-struct.
* lisp/url/url-parse.el (url-path-and-query): Do not artificially turn empty
path and query into nil path and query, respectively.
* lisp/url/url-expand.el (url-expander-remove-relative-links): Do not turn
empty path into an absolute ("/") path.
* lisp/url/url-expand.el (url-expand-file-name): Properly resolve
fragment-only URIs. Do not just return them unchanged.
* lisp/url/url-expand.el (url-default-expander): An empty path in the relative
reference URI should not drop the last segment.

Make relative URL parsing and resolution consistent with RFC 3986 (bug#22044)

* test/lisp/url/url-parse-tests.el: Add tests covering url-generic-parse-url.
* test/lisp/url/url-expand-tests.el: Add tests covering url-expand-file-name.
* lisp/url/url-parse.el (url-generic-parse-url): Keep empty fragment
information in URL-struct.
* lisp/url/url-parse.el (url-path-and-query): Do not artificially turn empty
path and query into nil path and query, respectively.
* lisp/url/url-expand.el (url-expander-remove-relative-links): Do not turn
empty path into an absolute ("/") path.
* lisp/url/url-expand.el (url-expand-file-name): Properly resolve
fragment-only URIs. Do not just return them unchanged.
* lisp/url/url-expand.el (url-default-expander): An empty path in the relative
reference URI should not drop the last segment.

Let url use default file modes when copying files

* lisp/url/url-handlers.el (url-copy-file): Use default file
modes when copying files (bug#11400).

Doc fix for url-http

* lisp/url/url-http.el (url-http): Document better return values
  (bug#13187) (tiny change)

* eww.el (eww-display-html): Support <button> tags (bug#20485).

Made ffap-url-p a defun instead of a defsubst

* lisp/ffap.el (ffap-url-p): Change from defsusbt to defun,
since there doesn't seem to be much of a reason for it to be a
defsubst (bug#18203).

Add a command to view files in the browser to dired

* lisp/dired.el (dired-mode-map): Add the `W' command
(bug#18810).

Allow http://user:pass@foo/ URLs again

* lisp/url/url-auth.el (url-basic-auth): Allow explicit
user/passwords in URLs (bug#19046).

* eww.el (eww-mode-map): Fix command name of eww-toggle-colors.

Autoload url-insert-buffer-contents

* lisp/url/url-handlers.el: Add autoload cookie so that
`package-list-packages' doesn't bug out (bug#21927) (tiny change)

Allow toggling colors in eww

* doc/misc/eww.texi (Basics): Mention "C".

* lisp/net/eww.el (eww-toggle-colors): New command and keystroke.

* lisp/net/shr.el (shr-use-colors): New variable.
(shr-colorize-region): Use it.

Follow meta refresh tags in eww

* eww.el (eww-tag-meta): Follow meta refresh tags (bug#22234).

More eww file name coding fixes

* eww.el (eww-decode-url-file-name): Use the base coding
system to check for encodability.

Always save eww history

* eww.el (eww-setup-buffer): Always save history, even when
called from outside the eww buffer (bug#19638).

Default web pages to right-to-left

* eww.el (eww-mode): Most web pages are left-to-right, so make
that the default (bug#19801).

* shr.el (shr-tag-html): Respect "dir" attributes
(left-to-right, right-to-left).

Make toggling checkboxes work again

* eww.el (eww-update-field): Make toggling checkboxes work
again (bug#21881).

Don't store cookies with empty names

* lisp/url/url-cookie.el (url-cookie-store): Refuse to store
cookies with empty names (bug#21936).

Stop rendering HTML before specdlr exhaustion

Fixes: 22117
* shr.el (shr-descend): Stop rendering before we run out of
specpdl room (bug#22117).

Use cl-reduce, not reduce.

Allow several <tbody> tags in shr

* shr.el (shr-table-body): New function to find the real body
of a table.
(shr-tag-table): Use it to render several <tbody> tags in a
table (bug#22170).

Make prettier unique file names in eww

(eww-make-unique-file-name): Make unique file names by making
files like foo(2).jpg instead of foo(1)(2).jpg.

Decode hex-encoded URLs before using them as file names

* eww.el (eww-decode-url-file-name): New function.
(eww-download-callback): Use it to decode file names before
saving them.

Add FreeBSD cert bundle

* doc/misc/emacs-gnutls.texi (Help For Users): Document
FreeBSD bundle.

* lisp/net/gnutls.el (gnutls-trustfiles): Add FreeBSD cert bundle.

Allow overriding shr functions from eww

* eww.el (eww-display-html): Allow overriding elements in
`shr-external-rendering-functions'.

Ignore invalid SVG images

* shr.el (shr-tag-svg): Ignore SVG images that have no width
or height, because these can't be displayed by ImageMagick,
anyway.

shr table rendering fix

* shr.el (shr-tag-table): Allow rendering body-less tables
that have headers.

clipboard should still work even if interprogram-* is disabled

(clipboard-yank): When `interprogram-cut-function' is nil,
bind it to `gui-selection-value' - the default value.
(clipboard-kill-region, clipboard-kill-ring-save): When
`interprogram-paste-function' is nil, bind it to `gui-select-text' -
the default value.

; Auto-commit of ChangeLog files.

Fix bootstrap issue with dired-loaddefs

* lisp/dired.el: Autoloads for secondary files loaded optionally.

dired generate autoloads to non-versioned file.

* lisp/dired.el: Remove autoloads.
* lisp/Makefile.in: Add dired to autogenel.
* lisp/dired-aux.el,lisp/dired-x.el: Update file local.
* test/lisp/dired-tests.el: Add new test.

eieio generate autoloads to non-versioned file.

* lisp/Makefile.in: eieio-loaddefs add to autogenel.
* lisp/emacs-lisp/eieio.el,lisp/emacs-lisp/eieio-core.el:
  Remove autoloads.
* lisp/emacs-lisp/eieio-compat.el,lisp/emacs-lisp/eieio-custom.el,
  lisp/emacs-lisp/eieio-opt.el: Update file local.
* test/lisp/emacs-lisp/eieio-tests/eieio-tests.el: New test.

htmlfontify generate autoload to non-versioned file.

* lisp/Makefile.in: Add htmlfontity-loaddefs to autogenel.
* lisp/hfy-cmap.el: Update file local.
* lisp/htmlfontify.el: Remove autoloads, add require.
* test/lisp/htmlfontify-tests.el: Test autoload functionality.

ibuffer generate autoloads to non-versioned file.

* lisp/Makefile.in: Add ibuffer-loaddefs to autogenel.
* lisp/ibuf-ext.el: Update file local.
* lisp/ibuffer.el: Remove autoloads and add a require.
* test/lisp/ibuffer-tests.el: Test that autoload is working.

rmail generate autoloads to non-versioned file.

* lisp/Makefile.in: Add rmail-loaddefs.el to autogenel.
* lisp/mail/rmail.el: Remove autoloads, add require.
* lisp/mail/rmailedit.el,lisp/mail/rmailkwd.el,
  lisp/mail/rmailmm.el,lisp/mail/rmailmsc.el,
  lisp/mail/rmailsort.el,lisp/mail/rmailsum.el,
  lisp/mail/undigest.el: Update file-local.
* test/lisp/mail/rmail-tests.el:

Add autoload-force target.

* lisp/Makefile.in (autoload-force): New target.

ps-print generate autoloads to non versioned file.

* lisp/Makefile.in: Add ps-print-loaddefs.el to autogen list.
* lisp/ps-print.el: Remove autoloads.
* lisp/ps-mule.el: Update file-local.
* test/lisp/ps-print-tests.el: Test autoload functionality.

reftex generate autoloads to non versioned file.

* lisp/Makefile.in: Add reftex-loaddefs to autogen files
* lisp/textmodes/reftex.el: Remove autoloads.
* lisp/textmodes/reftex-auc.el,lisp/textmodes/reftex-cite.el,
  lisp/textmodes/reftex-dcr.el,lisp/textmodes/reftex-global.el,
  lisp/textmodes/reftex-index.el,lisp/textmodes/reftex-parse.el,
  lisp/textmodes/reftex-ref.el,lisp/textmodes/reftex-sel.el,
  lisp/textmodes/reftex-toc.el: Update autoload file-local.
* test/lisp/textmodes/reftex-tests.el: Add test of an autoloaded
  function.

; Auto-commit of ChangeLog files.

* lisp/calculator.el (calculator-define-key): Undo last change

Make map argument mandatory instead (bug#22106).
(calculator-add-operators): Pass the argument that's not optional any more.

; Auto-commit of ChangeLog files.

* Makefile.in: Avoid duplication.

(have-tests): New rule.
(check, check-maybe): Use it.

make check unconditional, check-maybe top-level.

 * Makefile.in: Add check-maybe target.
 * test/Makefile.in: Restore unconditional behaviour to make check.

Merge branch 'master' of git.sv.gnu.org:/srv/git/emacs

Tests now support out-of-source-build.

 * tests/Makefile.in,test/make-test-deps.emacs-lisp: Remove assumptions
   about current working directory.

; * test/make-test-deps.emacs-lisp: Standardize license notice.

* lisp/emacs-lisp/let-alist.el: Now an Elpa :core package

; Auto-commit of loaddefs files.

Improve documentation and clean up.

 * test/Makefile.in: Improve documentation, use EMACS variable
   correctly, and clean up makefile rules.

Update file headers for name change.

 * (test/src/decompress-tests.el, test/src/alloc-tests.el): Update headers.

Test files renamed to new scheme.

 * (finalizer-tests.el): Now renamed alloc-tests.el
 * (zlib-tests.el): Now renamed decompress-tests.el.

Tests now depend on source files

 * test/Makefile.in: Include dependences from tests to source files.
 * test/make-test-deps.emacs-lisp: New file
 * .gitignore: Ignore generated make include file

* lisp/progmodes/which-func.el: Improve disabling the mode

Use lexical-binding.
(which-func-modes, which-func-non-auto-modes, which-func-maxout)
(which-func, which-func-format): Remove redundant :group arg.
(which-func-try-to-enable): New function.
(which-func-ff-hook, which-function-mode): Use it.
(mode-line-misc-info): Add ourselves here instead of in bindings.el.
* lisp/bindings.el (mode-line-misc-info): Remove which-func-mode entry.

* lisp/calculator.el (calculator-define-key): Silence warning

...about unknown calculator-mode-map.

* lisp/calculator.el: more improvements and bugfixes.

- Mark `calculator-paste-decimals' as obsolete.  (It wasn't having an
  effect anyway.)

- Simplify `calculator-number-to-string' by throwing most of the work
  onto `number-to-string', leaving just some tweaks for decimal inputs.
  This leads to some minor changes, for example, pasting "1x1" in hex
  mode would warn that "x" is ignored and result in "11" (and it wasn't
  done in decimal mode), whereas now it just ignores everything from the
  "x" and on and result in a "1" just like in decimal input mode.  Also,
  overflows are left for `number-to-string' to deal with.

- `calculator-paste' is very simple as a result.

- Extend the simplified `calculator-paste': with a prefix argument it
  pastes a string as if the characters were entered.  This can be used
  to reduce expressions, but note that it's a simple literal operation,
  so precedence can be messed, a number can be paster while entering a
  number, spaces and newlines matter, etc.

- Fix a minor bug where "e+" in hex mode wouldn't use "+" as an
  operator.

- Fix a bug in `calculator-put-value': avoid grouping in the display
  that is used to construct `calculator-curnum'.  This would trigger
  when pasting or getting a value from a register in some radix mode
  with a large enough value.  Another fix: make the output radix equal
  the input one, otherwise numbers could be converted twice.

* lisp/calculator.el: Re-do key bindings.

Use a helper function that arranges a parent keymap that binds alternate
case keys so if some letter key is unbound and it's un/shifted version
is, it will get used.  This makes the global-map trickery unnecessary.

Also switch to passing strings that name keys through `kbd'.

* lisp/calculator.el: improve radix modes

Fix prompt for some input radix with decimal output (eg, "BD" instead of
the incorrect "B="); also, some minor docstring tweaks for these.

* lisp/calculator.el: better reading of register names

Use `register-read-with-preview' with a dynamically bound
`register-alist' and a proper preview function to read register names.

* lisp/calculator.el: General improvements

Use things like `when', `unless', and `push'.

Improve `calculator-last-input' so it doesn't barf when hitting `F1' in
non-electric mode.

; Manual Cleanup of ChangeLog.2

; Manual Cleanup of ChangeLog.2

; Auto-commit of ChangeLog files.

; Pacify byte-compiler in filenotify-tests.el

Fix a problem with gfilenotify in filenotify-tests.el

* test/lisp/filenotify-tests.el
(file-notify--test-expected-events): Remove.
(file-notify--test-cleanup): Do not set that variable.
(file-notify--test-with-events): EVENTS can also be a list of lists.
(file-notify-test02-events, file-notify-test04-file-validity):
Adapt expected result.

* .gitignore: Adjust to changes in 'test' directory structure.

Fix test/manual/etags/Makefile

* test/manual/etags/Makefile (ETAGS_PROG, CTAGS_PROG): Adjust to
changes in 'test' directory structure.

Exclude resource dirs from search for tests.

* test/Makefile.in: Test file locations are now found with find
  rather than using finds native functions.

Add test targets without directory names.

 * (test/Makefile.in): Extend test_template to add two targets for each
   file.

* lisp/emacs-lisp/package.el: Require url-handlers

Move elisp-mode-tests to new function names.

 * test/lisp/progmodes/elisp-mode-tests.el (find-defsdefun-c-defvar-c,
 find-defs-defun-el-defvar-c): Call `elisp--xref-find-definitions'.

* lisp/emacs-lisp/package.el: Declare `url-insert-buffer-contents'

Merge branch 'feature/standard-test-location'

* lisp/emacs-lisp/eieio.el: Add some default implementations

(standard-class): Mark it obsolete.
(slot-missing): Give it a default implementation.
(destructor): Simplify and mark it obsolete.
(object-print): Give it a default implementation.
(eieio-change-class): Rename from change-class.
(change-class): Redefine as obsolete alias.

Mention kqueue in NEWS

; Merge from scratch/kqueue

The following commit was skipped:

e604e6a Merge branch 'scratch/kqueue' of git.sv.gnu.org:/srv/git/emacs into scratch/kqueue

Merge from scratch/kqueue

bec57a4 Some final fixes in file notification before merging with master
0247489 Rework file notifications, kqueue has problems with directory monitors
5154781 Continie with pending events
6b490c0 Improve loops in file-notify-test06-many-events
c8e266f Handle more complex rename operation in kqueue
5044bdf New test with a larger number of events.
65ba5a9 Further fixes for kqueue.
13f3508 Code cleanup of kqueue.c
99aa855 Doc changes for kqueue
8deebe1 Finish implementation in kqueue.c
90d6c69 * lisp/filenotify.el (file-notify-add-watch): Fix thinko.
e95b309 More work on kqueue
41d9bd0 Implement directory events
c571fc1 Build fixes for kqueue support.
e0a68f2 Continue kqueue implementation
7543d1c Work on kqueue
e3354e2 Add kqueue support
c6457ce Minor fix to comment indentation and typo in last commit
b92307f linum-mode plays more nicely with other margin-setting extensions
58e6235 * lisp/image-mode.el: Support encrypted file
9375652 * lisp/progmodes/verilog-mode.el (verilog-save-buffer-state): Add backquote
47f83b6 ; ChangeLog.2 fixes
7cc233e * lisp/emacs-lisp/package.el: Fix a decoding issue
5f9153f * lisp/emacs-lisp/package.el: Refactor -with-work-buffer-async
353f5e7 * lisp/progmodes/verilog-mode.el: Use with-silent-modifications
70f1fda ; Auto-commit of ChangeLog files.
ae0653b * CONTRIBUTE: Remove information about feature freeze.
9459456 Merge branch 'release-process-lowercase'
9a4aa0f Document the release process
f8cc14b * admin/release-process: Rename from admin/FOR-RELEASE.
dcd5877 gitmerge: Fix git log command
2ac79ae gitmerge: Try to detect cherry-picks
5f7a2a9 Increment Emacs version on master branch
ed2e7e2 Mention CONTRIBUTE in README
9e00a02 Update verilog-mode.el to 2015-11-09-b121d60-vpo.
138ad3d ; Fix warnings
7126e9a ; Update xref-etags-mode for the latest change
246d660 Use generic dispatch for xref backends
31f6e93 Support rectangular regions for more commands
f103a27 Handle multiple matches on the same line; add highlighting
fe973fc Replace xref-match-bounds with xref-match-length
92a5010 Merge from gnulib
04ac097 Spruce up ftfont.c memory allocation
4c4b520 Port recent XCB changes to 64-bit ‘long int’
4f0ce9c * src/undo.c (run_undoable_change): Now static.
695a6f9 Remove support for ':timeout' from w32 tray notifications
a731c2f * test/automated/simple-test.el: Add test for bug#20698 (bug#21885)
2b4c0c0 * lisp/progmodes/elisp-mode.el: Declare function `project-roots'
66b9f7b * src/undo.c: Small fixes for previous change
2fac30e Add a few more variables to redisplay--variables
04f69f1 * lisp/loadup.el: Enlarge the size of the hash table to 80000.
e221d32 Fix point positioning after transposing with negative arg
35f5afb Fix last change in shr.el
508e77b Fix last change
d60ed3f Another fix for MinGW64 and Cygwin builds due to notifications
805a39b Remove intern calls and XXX comments from Fx_export_frames
9463abf shr: don't invoke unbound function (Bug#21895)
6e5186e * test/automated/keymaps-test.el: Fix test to make it repeatable
0c92826 * test/automated/cl-lib-tests.el (cl-lib-struct-constructors): Small fix
39dbd1c : Tests for undo-auto functionality.
20aa42e ; Merge branch 'fix/no-undo-boundary-on-secondary-buffer-change'
44dfa86 The heuristic that Emacs uses to add an `undo-boundary' has been reworked, as it interacts poorly with functions on `post-command-hook' or `after-change-functions'.
d2f73db Bind [?\S-\ ] to previous line command in Dired-like modes.
c1bc6e5 Fix the MinGW64 and Cygwin-w32 builds
1e363a8 Enable sorting of JSON object keys when encoding
9dd7da9 * test/automated/keymap-tests.el: New test file
aa17de9 Speed up x_real_pos_and_offsets using XCB
a838c83 Enable use of XCB for checking window manager state
c7f2b6a Detect XCB and save a connection handle
e1c27db Reduce some data dependencies between X calls
25e32bd Use color cache for creating bitmap
851be0f Add "^" to the interactive specs of `dired-next/previous-line'
055ca3a Sync with soap-client repository, version 3.0.2
e0f64e7 CC Mode: Respect users' settings of open-paren-in-column-0-is-defun-start.
952395d * lisp/obarray.el: Fix shadowed variables
436d330 Avoid error in submitting a form with EWW
e887f6e ; * doc/lispref/os.texi: Fix indentation of sample code.
51d840a Rename seq-p and map-p to seqp and mapp
23036ba Rename obarray-p to obarrayp
20aea42 Rename obarray-foreach to obarray-map
a3b2101 New file with obarray functions.
9d43941 Implement tray notifications for MS-Windows

Merge branch 'scratch/kqueue' of git.sv.gnu.org:/srv/git/emacs into scratch/kqueue

Some final fixes in file notification before merging with master

* lisp/filenotify.el (file-notify--rm-descriptor): Remove WHAT arg.
(file-notify-callback): Improve check for `stopped' event.  Call
`file-notify-rm-watch' rather than `file-notify--rm-descriptor'.
(file-notify-add-watch): In case FILE is not a directory, call the
file monitor for the kqueue backend.  Otherwise, call the
directory monitor for the upper directory.

* src/inotify.c (inotifyevent_to_event): Extract file name from
watch_object if the event doesn't provide it.
(Finotify_add_watch): Add file name to watch_object.

* test/automated/file-notify-tests.el (file-notify--test-timeout):
Use different timeouts for different libraries.
(file-notify--test-with-events): Suppress lock files.  Flush
outstanding events before running the body.
(file-notify-test02-events, file-notify-test04-file-validity): Do
not skip cygwin tests.  Add additional test for file creation.
Adapt expected result for different backends.
(file-notify-test03-autorevert): Some of the tests don't work for
w32notify.
(file-notify-test06-many-events): Rename into both directions.

Rework file notifications, kqueue has problems with directory monitors

* lisp/filenotify.el (file-notify-add-watch): Call the native
add-watch function on the file, not on the dir.

* src/kqueue.c (kqueue_compare_dir_list): Make also bookkeeping
about already deleted entries.

* test/automated/auto-revert-tests.el
(auto-revert-test01-auto-revert-several-files): Do not call "cp -f"
since this deletes the target file first.

* test/automated/file-notify-tests.el (file-notify--test-event-test):
Make stronger checks.
(file-notify-test01-add-watch, file-notify-test02-events)
(file-notify-test04-file-validity, file-notify-test05-dir-validity):
Rewrite in order to call file monitors but directory monitors.
(file-notify-test06-many-events): Ler rename work in both directions.

Continie with pending events

* src/kqueue.c (pending_events): Remove global variable.
(kqueue_compare_dir_list): Create `write' event for not used
pending events.
(globals_of_kqueue): Remove initialization of pending_events.

Improve loops in file-notify-test06-many-events

* test/automated/file-notify-tests.el (file-notify-test06-many-events):
Use `read-event' pauses for the `write-file' loops; otherwise
events are lost in inotify and gfilenotify cases.

Handle more complex rename operation in kqueue

* src/kqueue.c (pending_events): New variable.
(kqueue_compare_dir_list): Handle more complex rename operation.
(globals_of_kqueue): Initialize pending_events.

* test/automated/file-notify-tests.el (file-notify-test06-many-events):
Adapt expected events in the `rename-file' case.
(file-notify-test06-many-events-remote): Declare.